home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 August / August CD.bin / Shareware / Programming / Help on Wheels ƒ / HoW Developer’s Kit 1.1 / HoWSample / HoWSample Help / HoWSample Help.rsrc / STR#_1026.txt < prev    next >
Encoding:
Text File  |  1994-06-05  |  4.1 KB  |  149 lines
  1. 
  2.  
  3. 
  4.  
  5. users not to move one file without the other.
  6.  
  7. merge the help data into the application, or keep it separate and tell your
  8.  
  9. approach of using alias records to track the help file, you can either
  10.  
  11. source code and Make file shows how to do all this.)  If you don‚Äôt like the
  12.  
  13. whenever the help file‚Äôs creation date changes.  (Again, the HoWSample
  14.  
  15. relativity data.  You should also do a ‚ÄúFind Original‚Äù to update the alias
  16.  
  17. file‚Äôs folder, then do a ‚ÄúFind Original‚Äù on it to force Finder to update its
  18.  
  19. the application file, you should first move the alias to the application
  20.  
  21. your application file using Rez.  If the help file is in a different folder from
  22.  
  23. make an alias to the help file, and pull the contained alias resource into
  24.  
  25. create such an alias record while building your application, ask Finder to
  26.  
  27. procedure, and the HoWSample source code shows how to call it.)  To
  28.  
  29. HoWFindHelpFile in the HoWLib interface library takes care of this entire
  30.  
  31. file.  (If this all sounds confusing, take heart.  The utility function
  32.  
  33. AppleShare password dialog if operating with a borrowed preferences
  34.  
  35. careful to specify no user interaction, so the user won‚Äôt see an
  36.  
  37. from session to session.  While resolving this alias record, you should be
  38.  
  39. your application file, and keep an updated version in your preferences file
  40.  
  41. your application file.  You should store this alias record as a resource in
  42.  
  43. file at registration time by resolving an alias record which is relative to
  44.  
  45. server keeps track during sessions.  One good way is to locate the help
  46.  
  47. responsible for keeping track of its movements between sessions; the
  48.  
  49. If your help file is separate from your application file, you are
  50.  
  51. 
  52.  
  53. unhides modal dialogs so that this is not a problem.
  54.  
  55. a sample modal dialog filter procedure which automatically hides and
  56.  
  57. when the user presses the Help key.  The HoWSample source code contains
  58.  
  59. also prevent the client engine from bringing the server to the foreground
  60.  
  61. NOTE:  Modal dialogs disable entries you place in the Help menu, and they
  62.  
  63. 
  64.  
  65. topic relevant to what the user is seeing.
  66.  
  67. modes, including dialogs, and in a context-sensitive fashion, displaying a
  68.  
  69. Command-? key combination (for keyboards which lack a Help key) in all
  70.  
  71. Second, it should react to the Help key (ASCII character value 5) and
  72.  
  73. user can select to get help on the entire application or on a specific topic.
  74.  
  75. help.  First, it should add one or more entries to the Help menu which the
  76.  
  77. For consistency, your application should support two methods of invoking
  78.  
  79. 
  80.  
  81. into the foreground before sending a Help event.
  82.  
  83. can still receive Help events, because the server always brings the client
  84.  
  85. background.  This is not a requirement, and foreground-only applications
  86.  
  87. Client applications should be able to receive events while running in the
  88.  
  89. 
  90.  
  91. requires no special knowledge of Apple events.
  92.  
  93. Macintosh, Volume VI, and elsewhere.  Beyond that, Help on Wheels
  94.  
  95. Documents, and Quit Application, are fully documented in Inside
  96.  
  97. events.  These events, Open Application, Open Documents, Print
  98.  
  99. allow this behavior, Finder assumes that you support the Required suite of
  100.  
  101. Apple events.  Once you set the bit in your application‚Äôs 'SIZE' resource to
  102.  
  103. friendly.  This is because the client engine and server converse using
  104.  
  105. To be a client of the help server, an application must be System 7
  106.  
  107. 
  108.  
  109. only with help files and does not talk back to clients.)
  110.  
  111. will operate under System 6 in a reduced mode, where the server deals
  112.  
  113. code.  (Later versions of Help on Wheels and its client interface library
  114.  
  115. versions, and any attempt to register a client will be met with an error
  116.  
  117. Manager.  Therefore, it does not work under System 6 or earlier
  118.  
  119. 7, such as the Alias Manager, the Process Manager, and the Apple Event
  120.  
  121. Help on Wheels uses several Toolbox managers which are new to System
  122.  
  123. 
  124.  
  125. 
  126.  
  127. will support Think C projects.
  128.  
  129. a little work, since it uses Pascal calling conventions.  The next version
  130.  
  131. for use with MPW C and C++.  MPW Pascal developers can use the kit with
  132.  
  133. The current version of the Help on Wheels developer‚Äôs kit is available only
  134.  
  135. 
  136.  
  137. 
  138.  
  139. åRequirements
  140.  
  141. ⌃
  142.  
  143. ⌃
  144.  
  145. 
  146.  
  147. 
  148.  
  149.